Modul: Master Data — Applications — Provinces
| Versi | 1.0 |
| Tanggal | 20 April 2026 |
| Aplikasi | IdProo Admin |
| Audiens | Administrator |
Dalam artikel ini
- Menampilkan Daftar Provinces
- Menambahkan Province
- Mencari Province
- Preview Informasi Province
- Mengubah Province
- Menghapus Province
- Import / Export Province
- Ringkasan Alur
- Solusi dan Tindakan Selanjutnya
1. Menampilkan Daftar Provinces
Halaman Provinces dapat diakses melalui navigasi: Master → Applications → Provinces.
Halaman ini menampilkan daftar seluruh provinsi yang telah terdaftar dalam sistem.
Gambar 1: Halaman Provinces menampilkan daftar provinsi dengan kolom Name, Country, dan Created at.
Kolom yang tersedia pada tabel Provinces:
| Kolom | Keterangan |
|---|---|
| Name | Nama provinsi yang dapat diklik untuk melihat detail informasi |
| Country | Nama negara tempat provinsi berada |
| Created at | Tanggal dan waktu data provinsi dibuat |
Saat kursor diarahkan ke baris provinsi, ikon Edit (✏) dan Delete (🗑) akan muncul di sebelah kanan baris tersebut.
2. Menambahkan Province
Untuk menambahkan provinsi baru, klik tombol + New province di pojok kiri atas tabel.
Gambar 2: Tombol + New province untuk menambahkan provinsi baru.
Panel Create new province akan terbuka di sisi kanan layar dengan form yang perlu diisi.
Gambar 3: Panel Create new province dengan field Name, Map ID, dan dropdown Country, serta tombol Save dan Cancel.
Form Create new province terdiri dari:
| Field | Keterangan |
|---|---|
| Name | Nama provinsi (wajib diisi) |
| Map ID | ID peta yang digunakan untuk identifikasi geografis provinsi (wajib diisi) |
| Country | Dropdown untuk memilih negara tempat provinsi berada (wajib diisi) |
Langkah-langkah menambahkan province:
- Klik tombol + New province.
- Isi field Name dengan nama provinsi.
- Isi field Map ID dengan ID peta yang sesuai.
- Pilih Country dari dropdown yang tersedia.
- Klik Save untuk menyimpan data.
Tips: Klik Cancel untuk membatalkan penambahan province dan menutup panel tanpa menyimpan perubahan.
3. Mencari Province
Search bar di pojok kanan atas tabel digunakan untuk mencari provinsi berdasarkan nama.
Gambar 4: Pencarian dengan kata kunci "Provinsi" memfilter daftar dan menampilkan hasil yang cocok.
Catatan: Pencarian bersifat dinamis — daftar akan diperbarui seiring pengetikan. Klik ikon × di sebelah kanan kolom pencarian untuk menghapus filter dan menampilkan kembali seluruh daftar provinsi.
4. Preview Informasi Province
Administrator dapat melihat detail informasi provinsi dengan mengklik nama provinsi pada daftar.
Gambar 5: Arahkan kursor ke baris provinsi; ikon Edit dan Delete muncul di sisi kanan baris.
Panel detail akan terbuka di sisi kanan layar dan menampilkan informasi lengkap provinsi.
Gambar 6: Panel detail Province menampilkan ID, Map Id, Country, Created at, Created by, Last modified, Last modified by, dan tombol Close.
Informasi yang ditampilkan pada panel detail:
| Informasi | Keterangan |
|---|---|
| ID | Identifikasi unik provinsi dalam sistem |
| Map Id | ID peta yang terkait dengan provinsi |
| Country | Negara tempat provinsi berada |
| Created at | Tanggal dan waktu data provinsi dibuat |
| Created by | Akun yang membuat data provinsi |
| Last modified | Tanggal dan waktu terakhir data diubah |
| Last modified by | Akun yang terakhir mengubah data provinsi |
Klik tombol Close untuk menutup panel detail.
5. Mengubah Province
Untuk mengubah data provinsi yang sudah ada, arahkan kursor ke baris provinsi yang ingin diubah, lalu klik ikon Edit (✏) yang muncul di sebelah kanan baris.
Gambar 7: Tooltip "Edit" muncul saat kursor diarahkan ke ikon Edit (✏) pada baris provinsi.
Panel Edit province akan terbuka di sisi kanan layar dengan data provinsi yang sudah ada, siap untuk diubah.
Gambar 8: Panel Edit province menampilkan field yang sama dengan Create, berisi data provinsi yang sudah ada.
Langkah-langkah mengubah province:
- Arahkan kursor ke baris provinsi yang ingin diubah.
- Klik ikon ✏ (Edit) yang muncul di sisi kanan baris.
- Ubah field yang diperlukan (Name, Map ID, atau Country).
- Klik Save untuk menyimpan perubahan.
Catatan: Struktur panel Edit province identik dengan panel Create new province, meliputi field Name, Map ID, dan dropdown Country.
6. Menghapus Province
6.1 Menghapus Satu Province
Untuk menghapus satu provinsi, arahkan kursor ke baris provinsi yang ingin dihapus, lalu klik ikon Delete (🗑) yang muncul di sebelah kanan baris.
Gambar 9: Tooltip "Delete" muncul saat kursor diarahkan ke ikon Delete (🗑) pada baris provinsi.
Dialog konfirmasi Delete Provinces akan muncul. Klik Delete (merah) untuk mengonfirmasi penghapusan, atau Cancel untuk membatalkan.
6.2 Menghapus Beberapa Province Sekaligus
Untuk menghapus lebih dari satu provinsi sekaligus, gunakan checkbox pada setiap baris.
Gambar 10: Centang checkbox pada setiap baris yang ingin dihapus. Tombol "Delete item (N)" muncul di toolbar atas.
Langkah-langkah menghapus beberapa province:
- Centang checkbox di sebelah kiri setiap provinsi yang ingin dihapus.
- Tombol Delete item (N) akan muncul di toolbar atas, di mana N adalah jumlah item yang dipilih.
- Klik tombol Delete item (N).
Dialog konfirmasi Delete Provinces akan muncul.
Gambar 11: Dialog konfirmasi "Are you sure to delete this Provinces?" sebelum penghapusan dieksekusi.
- Klik Delete untuk mengonfirmasi, atau Cancel untuk membatalkan.
Jika penghapusan berhasil, notifikasi sukses akan muncul.
Gambar 12: Notifikasi "Data deleted successfully" muncul setelah provinsi berhasil dihapus.
⚠️ Perhatian: Penghapusan provinsi bersifat permanen dan tidak dapat dibatalkan. Pastikan provinsi yang dipilih sudah benar sebelum mengklik Delete.
6.3 Error: Province Masih Memiliki Regencies
Apabila provinsi yang akan dihapus masih memiliki data regencies (kabupaten/kota) yang terhubung, sistem akan menampilkan pesan error dan penghapusan tidak dapat dilakukan.
Gambar 13: Pesan error "Cannot perform this operation. Province has regencies. Please delete the regencies first." muncul saat mencoba menghapus provinsi yang masih memiliki regencies.
Solusi: Hapus terlebih dahulu seluruh data regencies yang berada di bawah provinsi tersebut sebelum menghapus provinsinya.
7. Import / Export Province
Fitur Import dan Export dapat diakses melalui menu ⋯ OPTION di pojok kanan atas tabel.
Gambar 14: Menu ⋯ OPTION terbuka menampilkan pilihan Refresh, Import, dan Export.
7.1 Import Province
Fitur Import digunakan untuk menambahkan data provinsi secara massal melalui file spreadsheet.
Gambar 15: Pilihan Import pada menu OPTION.
Klik Import untuk membuka dialog Import data.
Gambar 16: Dialog Import data dengan area Drag & Drop/Browse, keterangan format file, dan tautan unduh Template example.
Dialog Import data menampilkan:
| Elemen | Keterangan |
|---|---|
| Area Drag & Drop / Browse | Area untuk menyeret file atau mengklik untuk membuka file browser |
| Format file | File yang didukung: XLS dan XLSX |
| Template example / Download | Tautan untuk mengunduh file template sebagai panduan format data yang benar |
Langkah-langkah import province:
- Klik ⋯ OPTION → pilih Import.
- Unduh Template example jika belum memiliki format file yang sesuai.
- Seret file XLS/XLSX ke area Drag & Drop, atau klik Browse untuk memilih file dari komputer.
Gambar 17: File browser untuk memilih file XLS/XLSX yang akan diimpor.
- Pilih file XLS/XLSX yang berisi data provinsi, lalu klik Open.
- Sistem akan memproses file secara otomatis.
Gambar 18: Notifikasi "Importing data..." berwarna biru muncul saat proses import sedang berjalan di latar belakang.
Catatan: Proses import berjalan di latar belakang. Notifikasi "Importing data..." akan muncul selama proses berlangsung. Pastikan file menggunakan format template yang benar agar data dapat diimpor dengan tepat.
7.2 Export Province
Fitur Export digunakan untuk mengunduh data provinsi ke dalam file spreadsheet Excel.
Gambar 19: Pilihan Export pada menu OPTION.
Klik Export untuk membuka dialog Export data.
Gambar 20: Dialog Export data dengan pilihan This page atau All page, dan tombol Export.
Dialog Export data menawarkan dua opsi cakupan data:
| Opsi | Keterangan |
|---|---|
| This page | Mengekspor hanya data provinsi yang ditampilkan pada halaman aktif |
| All page | Mengekspor seluruh data provinsi dari semua halaman |
Langkah-langkah export province:
- Klik ⋯ OPTION → pilih Export.
- Pilih cakupan data: This page atau All page.
- Klik tombol Export.
- Dialog Save As akan muncul untuk menentukan lokasi penyimpanan file.
Gambar 21: Dialog Save As dengan nama file otomatis Provinces-YYYYMMDDHHMMSS.xlsx dan format Microsoft Excel Worksheet.
- Konfirmasi nama file dan lokasi penyimpanan, lalu klik Save.
Gambar 22: Notifikasi unduhan browser menampilkan nama file dan ukuran file yang berhasil diunduh (5.2 KB • Done).
Catatan: Nama file hasil export menggunakan format otomatis
Provinces-YYYYMMDDHHMMSS.xlsx, di mana YYYYMMDDHHMMSS adalah timestamp saat file diekspor. File disimpan dalam format Microsoft Excel Worksheet (.xlsx).
8. Ringkasan Alur
Master Data → Applications → Provinces
│
├── [Lihat] Daftar provinsi (Name | Country | Created at)
│ Klik nama → Panel detail (ID, Map Id, Country,
│ Created at, Created by, Last modified,
│ Last modified by, Close)
│
├── [Tambah] + New province → Panel Create new province
│ ├── Isi Name
│ ├── Isi Map ID
│ ├── Pilih Country (dropdown)
│ └── Save → province muncul di daftar
│
├── [Cari] Search bar → ketik nama → daftar terfilter
│ × → hapus filter → tampilkan semua
│
├── [Edit] Hover baris → klik ✏ (Edit)
│ → Panel Edit province (field sama dengan Create)
│ ├── Ubah field yang diperlukan
│ └── Save → perubahan tersimpan
│
├── [Hapus]
│ ├── Satu item → Hover baris → klik 🗑 (Delete)
│ │ → Konfirmasi "Delete Provinces" → Delete
│ │ └── Sukses: "Data deleted successfully"
│ │
│ ├── Beberapa → Centang checkbox beberapa baris
│ │ item → Tombol "Delete item (N)" muncul
│ │ → Klik Delete item (N)
│ │ → Konfirmasi "Delete Provinces" → Delete
│ │ └── Sukses: "Data deleted successfully"
│ │
│ └── Error → "Province has regencies."
│ → Hapus regencies terlebih dahulu
│
└── [Import/ ⋯ OPTION
Export] ├── Import → Dialog Import data
│ │ ├── Drag & Drop / Browse file XLS/XLSX
│ │ ├── Download Template example (jika perlu)
│ │ └── Proses → notifikasi "Importing data..."
│ │
│ └── Export → Dialog Export data
│ ├── Pilih: This page / All page
│ ├── Klik Export
│ └── Save As → Provinces-YYYYMMDDHHMMSS.xlsx
9. Solusi dan Tindakan Selanjutnya
| Masalah | Kemungkinan Penyebab | Solusi |
|---|---|---|
| Tombol + New province tidak berfungsi | Hak akses Administrator tidak mencukupi | Hubungi Super Admin untuk memverifikasi hak akses pengelolaan Provinces |
| Dropdown Country tidak menampilkan pilihan | Data Countries belum tersedia di sistem | Tambahkan data negara terlebih dahulu melalui modul Master → Applications → Countries |
| Province tersimpan tetapi tidak muncul di daftar | Cache browser atau filter pencarian aktif | Refresh halaman (F5 atau Ctrl+R); pastikan search bar kosong |
| Perubahan pada Edit tidak tersimpan | Koneksi terputus atau tombol Save belum diklik | Periksa koneksi jaringan; pastikan klik Save sebelum menutup panel |
| Province tidak ditemukan saat pencarian | Kata kunci tidak cocok dengan nama provinsi | Periksa ejaan; klik × untuk mereset pencarian dan lihat seluruh daftar |
| Error "Province has regencies" saat menghapus | Province masih memiliki data regencies terhubung | Hapus seluruh regencies yang terhubung ke provinsi tersebut terlebih dahulu |
| Setelah dihapus, province masih muncul | Cache browser belum diperbarui | Refresh halaman (F5 atau Ctrl+R) untuk memuat ulang daftar terbaru |
| File import ditolak | Format file tidak didukung atau struktur data tidak sesuai template | Gunakan format XLS/XLSX; unduh dan ikuti Template example yang disediakan |
| Proses import tidak selesai / data tidak masuk | File berisi data tidak valid atau kolom tidak sesuai | Periksa kembali isi file; pastikan semua kolom wajib terisi sesuai template |
| File export tidak dapat dibuka | File rusak atau format tidak kompatibel | Pastikan aplikasi Microsoft Excel atau perangkat lunak kompatibel terinstal; coba export ulang |
| Dialog konfirmasi Delete tidak muncul | Koneksi lambat atau browser memblokir popup | Refresh halaman dan coba kembali; pastikan browser mengizinkan dialog |
Dokumen ini dibuat untuk keperluan panduan internal Administrator aplikasi IdProo.
© 2026 IdProo — Hak Cipta Dilindungi
